Favicon

You are here: Home > API Reference > Android > Enterprise Creation > Create EMM-managed enterprise

Create EMM-managed enterprise

Required Permission: mdm.android.enterprise.create

Creates a new EMM-managed enterprise with specified configuration and contact information.

POST
https://api.applivery.io/v1/organizations/{organizationId}/mdm/android/enterprise 
curl -X POST "https://api.applivery.io/v1/organizations/{organizationId}/mdm/android/enterprise" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "enterpriseDisplayName": "string",
  "contactInfo": {
    "contactEmail": "string",
    "dataProtectionOfficerName": "string",
    "dataProtectionOfficerEmail": "string",
    "dataProtectionOfficerPhone": "string",
    "euRepresentativeName": "string",
    "euRepresentativeEmail": "string",
    "euRepresentativePhone": "string"
  },
  "configuration": {
    "primaryColor": "string",
    "logo": "string",
    "contactEmail": "user@example.com",
    "contactPhone": "string"
  }
}'
const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/mdm/android/enterprise", {
  method: "POST",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "enterpriseDisplayName": "string",
    "contactInfo": {
      "contactEmail": "string",
      "dataProtectionOfficerName": "string",
      "dataProtectionOfficerEmail": "string",
      "dataProtectionOfficerPhone": "string",
      "euRepresentativeName": "string",
      "euRepresentativeEmail": "string",
      "euRepresentativePhone": "string"
    },
    "configuration": {
      "primaryColor": "string",
      "logo": "string",
      "contactEmail": "user@example.com",
      "contactPhone": "string"
    }
  }),
});

const data = await response.json();
import requests

response = requests.post(
    "https://api.applivery.io/v1/organizations/{organizationId}/mdm/android/enterprise",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
    json={
      "enterpriseDisplayName": "string",
      "contactInfo": {
        "contactEmail": "string",
        "dataProtectionOfficerName": "string",
        "dataProtectionOfficerEmail": "string",
        "dataProtectionOfficerPhone": "string",
        "euRepresentativeName": "string",
        "euRepresentativeEmail": "string",
        "euRepresentativePhone": "string"
      },
      "configuration": {
        "primaryColor": "string",
        "logo": "string",
        "contactEmail": "user@example.com",
        "contactPhone": "string"
      }
    },
)

data = response.json()

Request

Send your API key in the request header authorization
Example: Authorization: Bearer <token>

organizationId string
required
Unique identifier for organization managing Apple enterprise application deployments and configurations.
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

Body Params application/json
enterpriseDisplayName string required
User-facing enterprise name displayed within Google Play managed configurations interface and enrollment workflows visible to end users.
≤ 256 characters
contactInfo object required
Enterprise contact information including data protection officers and EU representatives required for GDPR compliance and user support.
contactEmail string required
Primary contact email address for enterprise administrative communications and support requests visible to managed device users.
≤ 256 characters
dataProtectionOfficerName string required
Full name of data protection officer responsible for GDPR compliance and privacy oversight required for EU operations.
≤ 256 characters
dataProtectionOfficerEmail string required
Email address of data protection officer enabling direct contact for privacy inquiries and data subject access requests.
≤ 256 characters
dataProtectionOfficerPhone string required
Phone number of data protection officer providing alternative communication channel for urgent privacy-related matters and compliance issues.
≤ 256 characters
euRepresentativeName string required
Full name of EU representative designated for GDPR Article 27 requirements when enterprise lacks EU establishment.
≤ 256 characters
euRepresentativeEmail string required
Email address of EU representative enabling contact for data protection matters within European Economic Area jurisdictions.
≤ 256 characters
euRepresentativePhone string required
Phone number of EU representative providing communication channel for supervisory authorities and data subjects within EU.
≤ 256 characters
configuration object required
Initial enterprise branding configuration including logo, colors, and contact details applied during EMM-managed enterprise provisioning.
primaryColor string optional
Hexadecimal color code or integer representation defining primary brand color for enrollment interfaces and management applications.
≤ 256 characters
logo string optional
URL or base64-encoded image data for enterprise logo displayed throughout device enrollment and management workflows.
contactEmail string optional
Primary contact email address for enterprise administrative communications and support requests visible to managed device users.
≤ 256 characters · Match pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ · Format: email
contactPhone string optional
Enterprise support phone number displayed to managed device users for technical assistance and administrative inquiries.
≤ 256 characters
{
    "enterpriseDisplayName": "string",
    "contactInfo": {
        "contactEmail": "string",
        "dataProtectionOfficerName": "string",
        "dataProtectionOfficerEmail": "string",
        "dataProtectionOfficerPhone": "string",
        "euRepresentativeName": "string",
        "euRepresentativeEmail": "string",
        "euRepresentativePhone": "string"
    },
    "configuration": {
        "primaryColor": "string",
        "logo": "string",
        "contactEmail": "user@example.com",
        "contactPhone": "string"
    }
}

Responses

200 Response application/json
status boolean required
data object required
id string required
Unique identifier for the EMM enterprise record enabling cross-reference operations between local database and Google Android Management API resources.
Match pattern: ^[a-fA-F0-9]{24}$
config object required
Enterprise configuration object containing Google-synchronized settings for branding, authentication, and operational parameters.
name string optional
Internal enterprise name used for administrative identification within the platform backend systems distinct from user-facing display labels.
≤ 128 characters
enterpriseDisplayName string optional
User-facing enterprise name displayed within Google Play managed configurations interface and enrollment workflows visible to end users.
≤ 256 characters
logo any optional
Enterprise branding logo configuration containing image URL and content hash for visual customization of enrollment and management interfaces.
primaryColor integer optional
Integer representation of primary brand color in ARGB format applied to enrollment screens and management interface elements.
≥ 0 · ≤ 9007199254740991
termsAndConditions array optional
Legal agreements and usage policies presented to users during device enrollment requiring acknowledgment before granting access.
enterpriseType string optional
Google enterprise configuration type indicating operational mode as either customer-managed or EMM-managed affecting ownership and control boundaries.
managedGooglePlayAccountsEnterpriseType string optional
Managed Google Play account type defining user account provisioning model and authentication requirements for application distribution workflows.
managedGoogleDomainType string optional
Google domain management type specifying organization's authentication relationship with Google Workspace affecting sign-in policies and account restrictions.
googleAuthenticationSettings any optional
Authentication policy configuration controlling Google account sign-in requirements and restrictions for managed device access.
error string optional
Error code indicating enterprise configuration or synchronization failure requiring administrative intervention for resolution.
unauthorized
_config any optional
Raw enterprise configuration object from Google Android Management API preserved for debugging and advanced troubleshooting scenarios.
adminEmail string optional
≤ 256 characters · Match pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ · Format: email
updatedAt string required
Timestamp recording most recent enterprise configuration modification enabling change tracking and audit trail maintenance.
createdAt string required
Timestamp marking initial enterprise creation providing foundational audit record and enabling lifecycle analysis.
{
    "status": true,
    "data": {
        "id": "string",
        "config": {
            "name": "string",
            "enterpriseDisplayName": "string",
            "logo": "string",
            "primaryColor": 0,
            "termsAndConditions": [
                "string"
            ],
            "enterpriseType": "string",
            "managedGooglePlayAccountsEnterpriseType": "string",
            "managedGoogleDomainType": "string",
            "googleAuthenticationSettings": "string"
        },
        "error": "unauthorized",
        "_config": "string",
        "adminEmail": "user@example.com",
        "updatedAt": "string",
        "createdAt": "string"
    }
}
400 Response application/json
status boolean optional
false
error object optional
code number optional
5050
message string optional
Feature not allowed for you billing plan
{
    "status": false,
    "error": {
        "code": 5046,
        "message": "Android Emm Enterprise already exists for this organization"
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4004
message string optional
Invalid Token
{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}
404 Response application/json
status boolean optional
false
error object optional
code number optional
3001
message string optional
Entity not found
{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}